home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 007a / hhg106s.zip / HHG.MAN < prev    next >
Text File  |  1990-09-09  |  12KB  |  337 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.             Household Goods Inventory Control Program(HHG)
  18.  
  19.                           HHG Version 1.06
  20.                              8/30/90
  21.  
  22.                 Copyright (c) M.J. Cloutier 1989,1990
  23.  
  24.  
  25.  
  26.  
  27. HHG
  28. Command
  29. ______________________________________________________
  30.  
  31. Purpose:  The Household Goods Inventory Management Program
  32.           (HHG) provides a reliable, easy-to-use method to
  33.           create and maintain a detailed inventory of personal
  34.           property.  HHG is menu-driven, provides full mouse
  35.           support and provides on-screen cuing and help functions
  36.           for convenient use by persons with little or no
  37.           computer operating experience.
  38.  
  39. Format:   [d:][path]HHG [Q] ([I] or [L] or [T])
  40.           (Q switch available in registered version only)
  41.  
  42. Type:     External
  43.  
  44. Remarks:  Specify parameters as follows:
  45.  
  46.           [d:][path] before HHG to specify the drive and path
  47.           that contain the HHG command file.
  48.  
  49.           [Q] Eliminates the "ticker-tape" noise (registered only)
  50.  
  51.           [I] -- IBM Proprinter & compatibles
  52.           [L] -- HP LaserJet & compatibles
  53.           [T] -- Toshiba or Qume 
  54.           (default is [E] for Epson & compatibles)
  55.  
  56.           Once in HHG, select the desired '.HHG' file (MUST end
  57.           in '.HHG') from those displayed in the current directory,
  58.           or select a file from a different drive or directory.
  59.           (registered users:  a properly formatted ASCII text file
  60.            ending in '.HHL' can also be chosen)
  61.  
  62.  
  63.  
  64. *** HHG SYSTEM OVERVIEW ***
  65.  
  66.     HHG was developed using Borland's Turbo Pascal 5.0 and TechnoJock's
  67. Turbo Toolkit (Ver 5.0).  The Turbo Toolkit was invaluable in the rapid
  68. coding of HHG.  I would highly recommend it to anyone doing serious
  69. program development in Turbo Pascal.
  70.  
  71.     HHG provides the following functionality:
  72.  
  73.     *  create and maintain a detailed listing of personal property
  74.        items through an interactive, menu-driven cuing sequence.
  75.  
  76.     *  accomodate any level of organization through the creation of
  77.        a heirarchy of major categories, sub-categories, and specific
  78.        items.
  79.  
  80.     *  each category can have up to 255 items or sub-categories.
  81.  
  82.     *  provide the ability to add, edit or delete any category,
  83.        sub-category or item.
  84.  
  85.     *  items consist of the following information:
  86.         - item name (required, all other fields optional)
  87.         - current value
  88.         - date acquired
  89.         - acquisition value
  90.         - serial number
  91.         - user comments
  92.  
  93.     *  enables the user to print the inventory on any IBM/Epson
  94.        compatible printer with or without full item comments.
  95.  
  96.     *  provides full mouse support
  97.  
  98.     *  allow printout of inventory as ASCII text file (registered only)
  99.  
  100.  
  101. *** HARDWARE REQUIREMENTS ***
  102.  
  103.     *  a minimum of 512K RAM
  104.     *  DOS version 3.0
  105.     *  Hard disk (desired, but not required)
  106.     *  IBM/Epson compatible printer (for hardcopy only)
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116. HHG User's Manual (Ver 1.06)                                Page 1
  117.  
  118.  
  119. *** USING HHG ***
  120.  
  121.     HHG should be installed on a hard drive, if possible.  HHG has the
  122. ability to operate on files consisting of over 3000 individual items, but
  123. you may find that operation on very large files is too slow on all but the
  124. fastest machines.  For that reason, I recommend that you create several small
  125. inventory files.  As an example, you could create a file for your household
  126. effects, another for your album or stamp collection, and yet another for your
  127. outdoor recreation equipment.  Operation on all files will be much quicker,
  128. and you will still be able to take advantage of the full functionality of the
  129. program.
  130.  
  131. *** OPERATION ***
  132.  
  133.     Type 'HHG' at the DOS prompt using appropriate switches [I] [Q] (see above).
  134. You will be presented with a directory of all available '.HHG' files.  You can
  135. select one of these, or you can create a new file by entering a file name
  136. (with path if desired) ending in '.HHG'.  As HHG accesses a file, it creates a
  137. backup with the extension '.BAK' to guard against inadvertent deletion.
  138. (Registered Users - When saving to an ASCII text file the backup has a '!HL'
  139.  extension)
  140.  
  141.     Items are added to the currently displayed category using <F2>, and
  142. Sub-Categories are added using <F3>.
  143.  
  144.     HHG keeps a running balance of the value of all items and categories.
  145. This balance is displayed as 'Current Value' in the upper right hand corner
  146. of the screen.
  147.  
  148. *** FUNCTION KEYS ***
  149.  
  150. For CATEGORIES:
  151.  
  152.     <ESC>:  MOVE_UP  - Moves Up one category to the 'Parent' of the currently
  153.                        displayed category
  154.     <F1> :  HELP     - Displays the Help Screen
  155.     <F2> :  ADD_CAT  - Adds a new subcategory, and moves down to this new,
  156.                        empty category
  157.     <F3> :  ADD_ITEM - Adds a new item to the currently displayed category
  158.     <F4> :  MOVE     - Allows rearrangement of the items/categories which
  159.                        make up the currently displayed category
  160.     <F5> :  DEL_CAT  - Allows deletion of the displayed category
  161.                        WARNING! - this will also delete all of the components
  162.                                   which make up the selected category
  163.     <F6> :  NAME     - Allows changing the name of the current category
  164.     <F7> :  PRINT    - Allows printing of the displayed category and all of
  165.                        its component parts (items/categories)
  166.     <F8> :  SAVE     - Save the current '.HHG' file
  167.     <F10>:  END      - Exit the program (prompts for SAVE)
  168.  
  169.  
  170. HHG User's Manual (Ver 1.06)                                Page 2
  171.  
  172. For ITEMS:
  173.  
  174.     <ESC>:  MOVE_UP  - Moves Up to the 'Parent' of the currently displayed item
  175.     <F1> :  HELP     - Displays the Help Screen
  176.     <F5> :  DEL_ITEM - Allows deletion of the displayed item
  177.     <F10>:  SAVE_CHG - Used to save editing changes made to displayed item,
  178.                        returns to the parent category upon completion
  179.  
  180. *** PRINTING ***
  181.  
  182.     HHG allows several different print functions/formats to printer and to
  183. disk (to disk for Register users only):
  184.  
  185.     *  A category can be printed without 'Item Information'.  This means
  186.        that the print out will only show the current values of all component
  187.        items/categories
  188.  
  189.     *  A category can be printed with 'Item Information' included.  This
  190.        means that all items will print with Comments, Acquisition Value,
  191.        Serial Number, and Acquisition Date (in addition to Current Value).
  192.  
  193.     *  A category can be written to an ASCII text file ending in '.HHL'.
  194.        This file will contain all item information and can be read back in
  195.        to HHG.  The primary user of this feature are those with non-standard
  196.        printers and those who want to modify the HHG data outside the program.
  197.        (Registered users)
  198.  
  199. *** HHL FILES ***
  200.  
  201.     '.HHL' files are ASCII text files properly formatted for use by HHG.  They
  202. can be created by HHG as mentioned above, or they can be created with an ASCII
  203. text editor and then read in to HHG. (Registed Users Only)
  204.  
  205.     If the '.HHL' file is created or modified using a text editor, the correct
  206. list order must be maintained.  This means that all items in a category must
  207. appear before subcategories.  The Format for '.HHL' files can most easily be
  208. seen by creating one using 'DUMMY.HHG' from inside the HHG program.
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.                         
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224. HHG User's Manual (Ver 1.06)                                Page 3
  225.  
  226. *** DISCLAIMER ***
  227.  
  228. EVEN THOUGH NO I HAVE TESTED THIS SOFTWARE AND REVIEWED THIS
  229. DOCUMENTATION, I MAKE NO WARRANTY OR REPRESENTATION, EITHER
  230. EXPRESSED OR IMPLIED, WITH RESPECT TO THE SOFTWARE, ITS QUALITY,
  231. PERFORMANCE, OR FITNESS FOR A PARTICULAR PURPOSE.
  232. IN NO EVENT WILL I, OR ANYONE ELSE WHO HAS BEEN INVOLVED IN
  233. THE CREATION, PRODUCTION, OR DELIVERY OF THIS PROGRAM, BE LIABLE
  234. FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES
  235. RESULTING FROM ANY DEFECT IN THE SOFTWARE OR ITS DOCUMENTATION,
  236. EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.  IN PARTICULAR,
  237. I SHALL HAVE NO LIABILITY FOR ANY PROGRAMS OR DATA STORED OR USED
  238. WITH THIS SOFTWARE, INCLUDING THE COSTS OF RECOVERING SUCH PROGRAMS
  239. OR DATA.
  240.  
  241. *** REGISTRATION ***
  242.  
  243.     Thanks for evaluating HHG.  HHG is a Shareware product.  As  such,
  244. it is made available to the general computing public for evaluation.
  245. If you find this program useful, a donation of $10 would be sincerely
  246. appreciated.  I would also like to hear from you concerning possible
  247. improvements to HHG.
  248.  
  249.                   M.J. CLOUTIER
  250.                   857 Midvale Lane
  251.                   San Jose, CA 95136-1522        
  252.  
  253.     I can be reached through the CRICKET BBS (Jim Robeson - SysOp) in
  254. Monterey, CA  at (408) 373-3773.
  255.  
  256. *** HISTORY OF REVISIONS ***
  257. v1.06 
  258.     - restore original screen on exit (PC XT problem)
  259.     - added support for Toshiba and Qume printers
  260.     - minor bug fixes
  261.     - changed address and phone number!
  262.  
  263. v1.05
  264.     - provided command line selection of IBM Proprinters and HP 
  265.       LaserJet printers
  266.     - allowed 'level jump' up to 10 levels for HHL files
  267.     - tightened up code (140k to 90k)
  268.     - compressed EXE using LZE (90k to 41k)
  269.  
  270. v1.04
  271.     - fixed various bugs on save/exit, HELP
  272.     - fixed bug that prevented printing very large inventories
  273.     - added support for international character set
  274.     - added switches for music/info (registered users only)
  275.     - added ablility to print file to disk as ASCII text (registered users only)
  276.     - increased flexibility for movement within Category
  277.     - increased Item descriptor field length
  278.     - modified print format for easier readability
  279.     - added more disk I/O error checking
  280.  
  281.  
  282.  
  283. HHG User's Manual (Ver 1.06)                                Page 4
  284.  
  285.  
  286. v1.03
  287.     - Increased Comments and Serial Number Field length
  288.     - Added more printer error checking
  289.  
  290. v1.02
  291.     - Automatic Backup of data files upon program entry.
  292.     - Simplify entry of values (eliminated cents).
  293.     - Fixed unusual date bug.
  294.     - Corrected bug in MOVE procedure.
  295.  
  296. v1.01
  297.     - Initial program release.
  298.  
  299.                     HERE'S HOW SHAREWARE WORKS:
  300.  
  301. You are encouraged to copy the Household Goods Inventory Program diskettes
  302. and share them freely with others.  You have the luxury of trying out the
  303. complete programs at your own pace and in the comfort of your own home 
  304. or workplace.  This is not a crippled or "demo" copy, but the complete 
  305. working version of the program.
  306.  
  307. After you have used HHG for a reasonable evaluation period, you should
  308. either discontinue use of the program or purchase a licensed copy.  Your
  309. support is important and greatly appreciated.  With it, Shareware authors
  310. are encouraged to design and distribute new products. Without it, a great
  311. deal of high quality, low cost software will cease to be available.
  312.  
  313. Why pay at all?
  314. --------------------------------------------------------------
  315.    *  You receive a CURRENT copy of the program
  316.    *  Notification of updates and new versions
  317.    *  Inexpensive upgrade offers
  318.    *  Notification of new products
  319.    *  Your input and ideas help shape future products
  320.    *  A sense of pride and ownership in having honestly
  321.       participated in the Shareware revolution
  322.    *  You help to keep software prices down by supporting a
  323.       distribution method which doesn't depend on expensive
  324.       advertising campaigns.
  325.  
  326. So please dive in and enjoy the fun of legally sharing good software with
  327. your friends and associates. But also be aware of the restrictions, designed
  328. to protect the community of Shareware users and to prevent greedy people from
  329. taking unfair advantage of the trust, hardwork and good will of Shareware
  330. authors.  Exceptions to any of the above listed conditions must be received
  331. in writing from M.J. Cloutier.
  332.  
  333.  
  334.  
  335.  
  336.  
  337. HHG User's Manual (Ver 1.06)                                Page 5